Implement Georgia State Supplementary Payment (SSP) by hua7450 · Pull Request #7885 · PolicyEngine/policyengine-us

hua7450 · 2026-03-26T04:57:35Z

Summary

Implements Georgia's State Supplementary Payment (SSP) — a flat per-person supplement for SSI recipients in Medicaid nursing homes.

Regulatory Authority

Georgia PAMMS 2578: State Supplement Payment Amounts
CMS State Plan Amendment GA 18-0004: Personal Needs Allowance Increase for Nursing Home Residents
42 CFR 447.205; 42 CFR 440.40; 20 CFR § 416.414

Program Overview

Administration: State-administered (not in POMS federally-administered table)
Funding: State funds
Facility type: Medicaid nursing homes and institutionalized hospice

Eligibility

Requirement	Source	How Modeled
Federal SSI institutional living arrangement	20 CFR § 416.414	`ssi_federal_living_arrangement == MEDICAL_TREATMENT_FACILITY`
In GA nursing home or institutionalized hospice	PAMMS 2578	`ga_ssp_in_nursing_home_or_institutionalized_hospice`
Receives SSI at institutional rate ($30/mo)	PAMMS 2578 ("SSI-only recipients")	`ssi == medical_facility parameter`
Georgia resident	State program	`defined_for = StateCode.GA`
Level of Care approval	PAMMS 2578	Not modeled (clinical/administrative)
60-month resource transfer lookback	PAMMS 2578	Not modeled (administrative audit)

Benefit Amounts (PAMMS 2578, CMS SPA GA 18-0004)

Effective Date	State Supplement	Federal PNA	Total PNA
2006-07-01	$20/mo	$30/mo	$50/mo
2018-07-01	$35/mo	$30/mo	$65/mo
2019-07-01	$40/mo	$30/mo	$70/mo

Couple treatment: flat per-person (no separate couple rate)

Naming Alignment

Replaced ga_ssp_in_medicaid_facility (fake federal name) with federal ssi_federal_living_arrangement + state-specific ga_ssp_in_nursing_home_or_institutionalized_hospice
Follows SSP naming rubric: ssi_* for federal concepts, ga_* for state concepts

Files

parameters/gov/states/ga/dhs/ssp/
variables/gov/states/ga/dhs/ssp/
tests/policy/baseline/gov/states/ga/dhs/ssp/

Test plan

GA SSP tests pass
CI passes

🤖 Generated with Claude Code

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

codecov · 2026-03-26T05:44:53Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.82%. Comparing base (29d1ea6) to head (46eaaf1).
⚠️ Report is 26 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #7885      +/-   ##
==========================================
- Coverage   96.00%   94.82%   -1.18%     
==========================================
  Files           1        5       +4     
  Lines          25       58      +33     
  Branches        3        2       -1     
==========================================
+ Hits           24       55      +31     
- Misses          0        1       +1     
- Partials        1        2       +1

Flag	Coverage Δ
unittests	`94.82% <100.00%> (-1.18%)`	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

… tests - Add uncapped_ssi > 0 check to ga_ssp_eligible_person (is_ssi_eligible alone does not include income test — must verify person actually receives SSI) - Fix ODIS URL (302 redirect) → direct PAMMS 2578 URL - Fix CMS SPA #page=2 → #page=5 (actual PNA amounts table) - Add defined_for = StateCode.GA to ga_ssp_in_medicaid_facility - Annotate SSA 2011 reference as ($20 value only) - Add 12 eligibility tests: singles (income levels, zero boundary) + couples (both eligible, one high income, both high income, both not SSI-eligible, mixed) - Add 2 income-based integration tests for couples - Remove sources/working_references.md (intentional) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

MaxGhenis · 2026-03-27T14:08:46Z

Follow-up fixes pushed on this branch:\n\n- changed GA SSP eligibility to key off actual receipt rather than \n- applied the federal Title XIX facility SSI cap for Georgia Medicaid-facility residents so the supplement no longer stacks on top of community-rate SSI\n- wired into the shared household/SPM benefit aggregates\n- added regression coverage for reduced-SSI facility cases and for people who are SSI-eligible but do not take up SSI\n\nLocal verification: , , and targeted All checks passed! all passed.

MaxGhenis · 2026-03-27T14:09:06Z

Follow-up fixes pushed on this branch:

changed GA SSP eligibility to key off actual SSI receipt rather than uncapped_ssi
applied the federal Title XIX facility SSI cap for Georgia Medicaid-facility residents so the supplement no longer stacks on top of community-rate SSI
wired ga_ssp into the shared household/SPM benefit aggregates
added regression coverage for reduced-SSI facility cases and for people who are SSI-eligible but do not take up SSI

Local verification: policyengine_us/tests/policy/baseline/gov/states/ga/dhs/ssp/integration.yaml, policyengine_us/tests/policy/baseline/gov/states/ga/dhs/ssp/ga_ssp_eligible_person.yaml, and targeted ruff check all passed.

Resolve conflicts: - household_state_benefits.yaml: keep both de_child_care_subsidies and ga_ssp - ssi_amount_if_eligible.py: take upstream's generic federal medical facility logic, drop redundant GA-specific $30 cap block Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

- Replace ga_ssp_in_medicaid_facility with federal ssi_federal_living_arrangement == MEDICAL_TREATMENT_FACILITY - Add state-specific ga_ssp_in_nursing_home_or_institutionalized_hospice - Tighten eligibility to ssi == institutional rate ($30), matching PAMMS 2578 "SSI-only recipients" language - Simplify ga_ssp_person to use adds with parameter path - Add ssi_federal_living_arrangement output to integration tests - Update references to PAMMS and CMS SPA GA 18-0004 Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

- Fix wrong PDF page anchor for GA 19-0010 (#page=3 → #page=4) - Replace broken SSA URL with live PAMMS 2578 reference - Clean up reference titles (remove calculation commentary) - Replace fragile float == with ssi_amount > 0 in eligibility check - Remove irrelevant ABD Limits reference from all variable files - Update programs.yaml: status complete, add variable field Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

PavelMakarchuk · 2026-04-15T15:31:40Z

Fixes Applied

🔴 Critical Issues Fixed

✅ Wrong PDF page anchor: GA 19-0010 #page=3 → #page=4 (page 3 was the CMS-179 form, not the PNA amounts)
✅ Broken SSA URL: Replaced 403-returning ssa.gov link with live PAMMS 2578 reference

🟡 Should-Address Issues Fixed

✅ Fragile float equality: Replaced ssi_amount == federal_institutional_rate with ssi_amount > 0 (in_federal_medicaid_facility already confirms institutional arrangement)
✅ Irrelevant ABD Limits reference: Removed from all 4 variable files (covered Medicaid resource limits, not SSP)
✅ Reference title commentary: Cleaned up CMS SPA titles to identify document/section only
✅ programs.yaml: Updated GA SSP to status: complete with variable: ga_ssp

Verification

✅ All 31 tests pass
✅ Code formatted (make format)
✅ Lint passes

🤖 Generated with Claude Code

hua7450 and others added 2 commits March 26, 2026 00:57

Initial commit for Georgia SSP implementation

c672114

Implement Georgia State Supplementary Payment (SSP)

87e3e97

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

hua7450 marked this pull request as ready for review March 26, 2026 20:40

Fix Georgia SSP SSI receipt handling

090e8ad

MaxGhenis and others added 4 commits March 28, 2026 10:24

Merge upstream/main into ga-ssp

df05cd5

add tests

23cff6e

hua7450 requested review from MaxGhenis and PavelMakarchuk April 14, 2026 21:14

PavelMakarchuk approved these changes Apr 15, 2026

View reviewed changes

PavelMakarchuk merged commit 0d8ec0b into PolicyEngine:main Apr 15, 2026
8 of 9 checks passed

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Implement Georgia State Supplementary Payment (SSP)#7885

Implement Georgia State Supplementary Payment (SSP)#7885
PavelMakarchuk merged 9 commits intoPolicyEngine:mainfrom
hua7450:ga-ssp

hua7450 commented Mar 26, 2026 •

edited

Loading

Uh oh!

codecov Bot commented Mar 26, 2026 •

edited

Loading

Uh oh!

MaxGhenis commented Mar 27, 2026

Uh oh!

MaxGhenis commented Mar 27, 2026

Uh oh!

PavelMakarchuk commented Apr 15, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

hua7450 commented Mar 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Regulatory Authority

Program Overview

Eligibility

Benefit Amounts (PAMMS 2578, CMS SPA GA 18-0004)

Naming Alignment

Files

Test plan

Uh oh!

codecov Bot commented Mar 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

MaxGhenis commented Mar 27, 2026

Uh oh!

MaxGhenis commented Mar 27, 2026

Uh oh!

PavelMakarchuk commented Apr 15, 2026

Fixes Applied

🔴 Critical Issues Fixed

🟡 Should-Address Issues Fixed

Verification

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

hua7450 commented Mar 26, 2026 •

edited

Loading

codecov Bot commented Mar 26, 2026 •

edited

Loading